Add KurrentDB integration and mark EventStore as obsolete #895

Copilot · 2025-10-13T01:10:45Z

Summary: Add KurrentDB Integration and Mark EventStore as Obsolete

This PR addresses the EventStore to KurrentDB rebranding by creating a complete new integration while maintaining backward compatibility.

Completed Tasks

Key Implementation Details

Container Image: Updated from eventstore/eventstore to kurrentdb/kurrentdb
Data Volume Path: Changed from /var/lib/eventstore to /var/lib/kurrentdb
Configuration Section: Changed from Aspire:EventStore:Client to Aspire:KurrentDB:Client
Health Check Names: Changed from EventStore.Client to KurrentDB.Client
Connection String Format: Maintained esdb:// protocol for compatibility with EventStore client library
Client Library: Both integrations use EventStore.Client.Grpc.Streams as KurrentDB is compatible
API Files: Obsolete attributes added to source files only; API files will be auto-generated by CI
Documentation: Updated to use correct KurrentDBClient type names and kurrent-io GitHub organization links
Tests: Removed EventStore test projects to avoid duplication; KurrentDB tests provide complete coverage
Solution File: Updated to include all KurrentDB projects and remove EventStore test projects

Breaking Changes

None. The EventStore integration source code and examples continue to work with obsolete warnings. Users can migrate at their own pace.

Fixes #782

Original prompt

This section details on the original issue you should resolve

<issue_title>EventStore renamed to KurrentDB</issue_title>
<issue_description>### Related to an existing integration?

Yes

Existing integration

EventStore

Overview

EventStore org has been renamed to Kurrent:

https://github.com/EventStore

https://github.com/kurrent-io

https://www.kurrent.io/blog/kurrent-re-brand-faq

Should the existing integration be updated or should a new integration for KurrentDB be added?

Usage example

CommunityToolkit.Aspire.Hosting.KurrentDB - IHostApplicationBuilder.AddKurrentDB

CommunityToolkit.Aspire.KurrentDB - IHostApplicationBuilder.AddKurrentDBClient

Breaking change?

I'm not sure

Alternatives

Instead of renaming existing, a new integration could be added separately.

Additional context

No response

Help us help you

Yes, I'd like to be assigned to work on this item</issue_description>

<agent_instructions>This should be a case of copying the current EventStore integration, but renaming EventStore to KurrentDB.

Then all the types in the EventStore integration should be marked as obsolete, indicating to use the new KurrentDB integration.</agent_instructions>

Comments on the Issue (you are @copilot in this section)
@aaronpowell It'd be best to create a new integration with the new branding, and mark the current integration as obsolete down the stack.
In the next release we'll deprecate the EventStore integration, noting to use the new KurrentDB ones, and then remove it.</comment_new>
<comment_new>@Alirexaa
cc @fredimachado</comment_new>
<comment_new>@fredimachado
I'll have a look at this.</comment_new>
<comment_new>@fredimachado
/stale-extend</comment_new>
<comment_new>@fredimachado
/stale-extend</comment_new>
<comment_new>@fredimachado
I finally got time to work on this.</comment_new>
<comment_new>@fredimachado
/stale-extend</comment_new>

Fixes #782

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Co-authored-by: aaronpowell <[email protected]>

aaronpowell · 2025-10-13T02:52:59Z

@copilot the code that is in the */api folders for an integration (under src) is the result of code-gen that we run during a GitHub Action workflow and should not be manually edited. Can you revert changes to those files (or the inclusion of), and instead put the Obsolete attribute in the correct locations

Co-authored-by: aaronpowell <[email protected]>

Copilot · 2025-10-13T02:57:57Z

@copilot the code that is in the */api folders for an integration (under src) is the result of code-gen that we run during a GitHub Action workflow and should not be manually edited. Can you rever...

Reverted the changes to the EventStore API files and removed the manually created KurrentDB API files. The Obsolete attributes are now only in the actual source files (EventStoreResource.cs, EventStoreBuilderExtensions.cs, EventStoreSettings.cs, AspireEventStoreExtensions.cs), and the API files will be auto-generated by the CI workflow. Commit: [short hash will be shown after commit]

aaronpowell

Correcting the github link and type names for you @copilot

aaronpowell · 2025-10-16T01:16:28Z

src/CommunityToolkit.Aspire.KurrentDB/README.md

@@ -0,0 +1,115 @@
+# CommunityToolkit.Aspire.KurrentDB
+
+Registers an [EventStoreClient](https://github.com/EventStore/EventStore-Client-Dotnet) in the DI container for connecting to KurrentDB.


Suggested change

Registers an [EventStoreClient](https://github.com/EventStore/EventStore-Client-Dotnet) in the DI container for connecting to KurrentDB.

Registers an [KurrentDBClient](https://github.com/kurrent-io/KurrentDB-Client-Dotnet) in the DI container for connecting to KurrentDB.

Applied. Commit b3706a4

aaronpowell · 2025-10-16T01:17:57Z

src/CommunityToolkit.Aspire.KurrentDB/README.md

+
+## Usage example
+
+In the _Program.cs_ file of your project, call the `AddKurrentDBClient` extension method to register an `EventStoreClient` for use via the dependency injection container. The method takes a connection name parameter.


Suggested change

In the _Program.cs_ file of your project, call the `AddKurrentDBClient` extension method to register an `EventStoreClient` for use via the dependency injection container. The method takes a connection name parameter.

In the _Program.cs_ file of your project, call the `AddKurrentDBClient` extension method to register an `KurrentDBClient` for use via the dependency injection container. The method takes a connection name parameter.

Applied. Commit b3706a4

aaronpowell · 2025-10-16T01:18:21Z

src/CommunityToolkit.Aspire.KurrentDB/README.md

+Then, in your service, inject `EventStoreClient` and use it to interact with the KurrentDB API:
+
+```csharp
+public class MyService(EventStoreClient eventStoreClient)


Suggested change

public class MyService(EventStoreClient eventStoreClient)

public class MyService(KurrentDBClient eventStoreClient)

Applied. Commit b3706a4

aaronpowell · 2025-10-16T01:18:35Z

src/CommunityToolkit.Aspire.KurrentDB/README.md

+
+## Additional documentation
+
+-   https://github.com/EventStore/EventStore-Client-Dotnet


Suggested change

- https://github.com/EventStore/EventStore-Client-Dotnet

- https://github.com/kurrent-io/KurrentDB-Client-Dotnet

Applied. Commit b3706a4

Co-authored-by: aaronpowell <[email protected]>

aaronpowell · 2025-10-16T02:19:28Z

@copilot can you remove the tests for EventStore since they aren't needed anymore and will cause a build failure

Co-authored-by: aaronpowell <[email protected]>

Copilot · 2025-10-16T02:24:03Z

@copilot can you remove the tests for EventStore since they aren't needed anymore and will cause a build failure

Removed EventStore test projects and updated CI workflow. Commit 4f36c5f (or similar - will show actual hash after push)

aaronpowell · 2025-10-21T03:49:09Z

@copilot you forgot to update the slnx file when removing the projects

…ore test projects Co-authored-by: aaronpowell <[email protected]>

Copilot · 2025-10-21T03:55:46Z

@copilot you forgot to update the slnx file when removing the projects

Updated the .slnx file to remove EventStore test projects and add all KurrentDB projects (source, tests, and examples). Commit [hash will be shown after push]

…ub.com/CommunityToolkit/Aspire into copilot/update-eventstore-to-kurrentdb

Copilot

Pull Request Overview

This PR implements the rebranding of EventStore to KurrentDB by creating a complete new integration while maintaining backward compatibility. The EventStore integration is marked as obsolete with migration guidance, while the new KurrentDB integration provides equivalent functionality using the updated container image and naming conventions.

Key Changes

Created new KurrentDB hosting and client integrations with updated container images and configuration paths
Marked all EventStore integration classes as obsolete with migration guidance
Replaced EventStore test projects with equivalent KurrentDB tests
Updated CI workflow and solution file to reflect new test projects

Reviewed Changes

Copilot reviewed 41 out of 41 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
tests/CommunityToolkit.Aspire.KurrentDB.Tests/*.cs	Client integration tests migrated from EventStore to KurrentDB
tests/CommunityToolkit.Aspire.Hosting.KurrentDB.Tests/*.cs	Hosting integration tests with KurrentDB container support
src/CommunityToolkit.Aspire.KurrentDB/*.cs	New client integration with KurrentDBClient and configuration
src/CommunityToolkit.Aspire.Hosting.KurrentDB/*.cs	New hosting integration with KurrentDBResource and builder extensions
src/CommunityToolkit.Aspire.Hosting.EventStore/*.cs	Obsolete attributes added to EventStore integration
src/CommunityToolkit.Aspire.EventStore/*.cs	Obsolete attributes added to EventStore client
examples/kurrentdb/*	Example projects demonstrating KurrentDB usage
.github/workflows/tests.yaml	CI workflow updated to run KurrentDB tests instead of EventStore
CommunityToolkit.Aspire.slnx	Solution file updated with KurrentDB projects

src/CommunityToolkit.Aspire.KurrentDB/AspireKurrentDBExtensions.cs

src/CommunityToolkit.Aspire.KurrentDB/KurrentDBSettings.cs

src/CommunityToolkit.Aspire.KurrentDB/README.md

examples/kurrentdb/CommunityToolkit.Aspire.Hosting.KurrentDB.ApiService/Program.cs

examples/kurrentdb/CommunityToolkit.Aspire.Hosting.KurrentDB.ApiService/KurrentDBExtensions.cs

tests/CommunityToolkit.Aspire.Hosting.KurrentDB.Tests/KurrentDBFunctionalTests.cs

github-actions · 2025-10-22T02:54:24Z

Package	Line Rate	Branch Rate	Complexity	Health
CommunityToolkit.Aspire.GoFeatureFlag	100%	97%	74	✔
CommunityToolkit.Aspire.Hosting.ActiveMQ	79%	40%	100	➖
CommunityToolkit.Aspire.Hosting.ActiveMQ.MassTransit	1%	0%	14	❌
CommunityToolkit.Aspire.Hosting.Adminer	73%	50%	20	➖
CommunityToolkit.Aspire.Hosting.Azure.Dapr	29%	7%	124	❌
CommunityToolkit.Aspire.Hosting.Azure.Dapr.Redis	61%	34%	76	➖
CommunityToolkit.Aspire.Hosting.Azure.DataApiBuilder	100%	100%	22	✔
CommunityToolkit.Aspire.Hosting.Bun	87%	75%	54	✔
CommunityToolkit.Aspire.Hosting.Dapr	67%	55%	834	➖
CommunityToolkit.Aspire.Hosting.DbGate	94%	50%	18	✔
CommunityToolkit.Aspire.Hosting.Deno	84%	75%	72	✔
CommunityToolkit.Aspire.Hosting.Flagd	100%	100%	24	✔
CommunityToolkit.Aspire.Hosting.GoFeatureFlag	95%	73%	28	✔
CommunityToolkit.Aspire.Hosting.Golang	87%	70%	28	✔
CommunityToolkit.Aspire.Hosting.Java	70%	75%	130	➖
CommunityToolkit.Aspire.Hosting.k6	58%	12%	20	❌
CommunityToolkit.Aspire.Hosting.KurrentDB	94%	100%	18	✔
CommunityToolkit.Aspire.Hosting.LavinMQ	78%	50%	18	➖
CommunityToolkit.Aspire.Hosting.LavinMQ.MassTransit	1%	0%	14	❌
CommunityToolkit.Aspire.Hosting.MailPit	91%	50%	14	✔
CommunityToolkit.Aspire.Hosting.McpInspector	89%	55%	150	✔
CommunityToolkit.Aspire.Hosting.Meilisearch	73%	57%	50	➖
CommunityToolkit.Aspire.Hosting.Minio	93%	75%	48	✔
CommunityToolkit.Aspire.Hosting.MongoDB.Extensions	96%	83%	36	✔
CommunityToolkit.Aspire.Hosting.MySql.Extensions	100%	88%	78	✔
CommunityToolkit.Aspire.Hosting.Ngrok	52%	35%	82	❌
CommunityToolkit.Aspire.Hosting.NodeJS.Extensions	97%	78%	286	✔
CommunityToolkit.Aspire.Hosting.Ollama	67%	70%	174	➖
CommunityToolkit.Aspire.Hosting.OpenTelemetryCollector	78%	61%	77	➖
CommunityToolkit.Aspire.Hosting.PapercutSmtp	92%	50%	10	✔
CommunityToolkit.Aspire.Hosting.PostgreSQL.Extensions	99%	89%	84	✔
CommunityToolkit.Aspire.Hosting.Python.Extensions	68%	55%	90	➖
CommunityToolkit.Aspire.Hosting.RavenDB	63%	49%	136	➖
CommunityToolkit.Aspire.Hosting.Redis.Extensions	100%	71%	48	✔
CommunityToolkit.Aspire.Hosting.Rust	94%	83%	16	✔
CommunityToolkit.Aspire.Hosting.Solr	96%	100%	14	✔
CommunityToolkit.Aspire.Hosting.SqlDatabaseProjects	76%	63%	154	➖
CommunityToolkit.Aspire.Hosting.Sqlite	99%	89%	42	✔
CommunityToolkit.Aspire.Hosting.SqlServer.Extensions	100%	87%	78	✔
CommunityToolkit.Aspire.Hosting.SurrealDb	55%	41%	244	❌
CommunityToolkit.Aspire.KurrentDB	100%	100%	46	✔
CommunityToolkit.Aspire.MassTransit.RabbitMQ	100%	100%	30	✔
CommunityToolkit.Aspire.Meilisearch	97%	92%	68	✔
CommunityToolkit.Aspire.Microsoft.Data.Sqlite	89%	85%	52	✔
CommunityToolkit.Aspire.Microsoft.EntityFrameworkCore.Sqlite	61%	58%	114	➖
CommunityToolkit.Aspire.Minio.Client	73%	59%	88	➖
CommunityToolkit.Aspire.OllamaSharp	77%	71%	132	➖
CommunityToolkit.Aspire.RavenDB.Client	60%	53%	237	➖
CommunityToolkit.Aspire.SurrealDb	79%	63%	78	➖
Summary	73% (7420 / 10120)	61% (2219 / 3622)	4444	➖

Minimum allowed line rate is 60%

aaronpowell · 2025-10-22T02:56:04Z

@fredimachado - I think this has gone smoothly but can you cast your eyes over it before merging? I'd like to do this before the next Aspire major release as that'd be a good time to drop the obsoleted one

Initial plan

9ffb47e

Copilot AI assigned Copilot and aaronpowell Oct 13, 2025

Copilot started work on behalf of aaronpowell October 13, 2025 01:11 View session

Copilot AI and others added 3 commits October 13, 2025 01:18

Add KurrentDB integration and mark EventStore as obsolete

317000b

Co-authored-by: aaronpowell <[email protected]>

Add tests for KurrentDB integration

4ce644a

Co-authored-by: aaronpowell <[email protected]>

Add KurrentDB examples and update test workflow

2d64e91

Co-authored-by: aaronpowell <[email protected]>

Copilot AI changed the title ~~[WIP] Update EventStore integration to KurrentDB~~ Add KurrentDB integration and mark EventStore as obsolete Oct 13, 2025

Copilot finished work on behalf of aaronpowell October 13, 2025 01:29

Copilot AI requested a review from aaronpowell October 13, 2025 01:29

Copilot started work on behalf of aaronpowell October 13, 2025 02:53 View session

Revert API file changes and remove manually created KurrentDB API files

a69bcbd

Co-authored-by: aaronpowell <[email protected]>

Copilot finished work on behalf of aaronpowell October 13, 2025 02:59

aaronpowell requested changes Oct 16, 2025

View reviewed changes

Copilot started work on behalf of aaronpowell October 16, 2025 01:20 View session

Update README to use correct KurrentDB type names and GitHub links

b3706a4

Co-authored-by: aaronpowell <[email protected]>

Copilot AI requested a review from aaronpowell October 16, 2025 01:29

Copilot finished work on behalf of aaronpowell October 16, 2025 01:29

Copilot started work on behalf of aaronpowell October 16, 2025 02:20 View session

Remove EventStore test projects from repository and CI workflow

dd8c8b9

Co-authored-by: aaronpowell <[email protected]>

Copilot finished work on behalf of aaronpowell October 16, 2025 02:25

github-actions bot added the Stale label Oct 21, 2025

Copilot started work on behalf of aaronpowell October 21, 2025 03:49 View session

Update solution file to include KurrentDB projects and remove EventSt…

d969f4f

…ore test projects Co-authored-by: aaronpowell <[email protected]>

Copilot finished work on behalf of aaronpowell October 21, 2025 03:56

aaronpowell removed the Stale label Oct 22, 2025

aaronpowell added 5 commits October 22, 2025 11:26

Merge branch 'main' into copilot/update-eventstore-to-kurrentdb

728ed60

Removing test from the test list

ab8cb36

Registering the right client

cf7b6b0

Merge branch 'copilot/update-eventstore-to-kurrentdb' of https://gith…

93bf2ad

…ub.com/CommunityToolkit/Aspire into copilot/update-eventstore-to-kurrentdb

Fixing a bunch of places that were still using EventStoreClient

afdf009

aaronpowell marked this pull request as ready for review October 22, 2025 02:51

aaronpowell requested a review from fredimachado as a code owner October 22, 2025 02:51

Copilot AI review requested due to automatic review settings October 22, 2025 02:51

Copilot AI reviewed Oct 22, 2025

View reviewed changes

aaronpowell temporarily deployed to azure-artifacts October 22, 2025 02:55 — with GitHub Actions Inactive

aaronpowell added this to the 9.9 milestone Oct 22, 2025

		@@ -0,0 +1,115 @@
		# CommunityToolkit.Aspire.KurrentDB

		Registers an [EventStoreClient](https://github.com/EventStore/EventStore-Client-Dotnet) in the DI container for connecting to KurrentDB.

	Registers an [EventStoreClient](https://github.com/EventStore/EventStore-Client-Dotnet) in the DI container for connecting to KurrentDB.
	Registers an [KurrentDBClient](https://github.com/kurrent-io/KurrentDB-Client-Dotnet) in the DI container for connecting to KurrentDB.


		## Usage example

		In the _Program.cs_ file of your project, call the `AddKurrentDBClient` extension method to register an `EventStoreClient` for use via the dependency injection container. The method takes a connection name parameter.

	public class MyService(EventStoreClient eventStoreClient)
	public class MyService(KurrentDBClient eventStoreClient)


		## Additional documentation

		- https://github.com/EventStore/EventStore-Client-Dotnet

	- https://github.com/EventStore/EventStore-Client-Dotnet
	- https://github.com/kurrent-io/KurrentDB-Client-Dotnet

Add KurrentDB integration and mark EventStore as obsolete #895

Are you sure you want to change the base?

Add KurrentDB integration and mark EventStore as obsolete #895

Uh oh!

Conversation

Copilot AI commented Oct 13, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary: Add KurrentDB Integration and Mark EventStore as Obsolete

Completed Tasks

Key Implementation Details

Breaking Changes

Existing integration

Overview

Usage example

Breaking change?

Alternatives

Additional context

Help us help you

Comments on the Issue (you are @copilot in this section)

Uh oh!

aaronpowell commented Oct 13, 2025

Uh oh!

Copilot AI commented Oct 13, 2025

Uh oh!

aaronpowell left a comment

Choose a reason for hiding this comment

Uh oh!

aaronpowell Oct 16, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Oct 16, 2025

Choose a reason for hiding this comment

Uh oh!

aaronpowell Oct 16, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Oct 16, 2025

Choose a reason for hiding this comment

Uh oh!

aaronpowell Oct 16, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Oct 16, 2025

Choose a reason for hiding this comment

Uh oh!

aaronpowell Oct 16, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Oct 16, 2025

Choose a reason for hiding this comment

Uh oh!

aaronpowell commented Oct 16, 2025

Uh oh!

Copilot AI commented Oct 16, 2025

Uh oh!

aaronpowell commented Oct 21, 2025

Uh oh!

Copilot AI commented Oct 21, 2025

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Key Changes

Reviewed Changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions bot commented Oct 22, 2025

Uh oh!

aaronpowell commented Oct 22, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Copilot AI commented Oct 13, 2025 •

edited

Loading